home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1998 #3 / Amiga Plus CD - 1998 - No. 3.iso / pd / spiele / frotz / frotz.txt < prev    next >
Text File  |  1997-02-08  |  7KB  |  172 lines
  1.  
  2. FROTZ V2.32 - an interpreter for all Infocom games. Complies with standard
  3. 1.0 of Graham Nelson's specification. Written by Stefan Jokisch in 1995-7
  4.  
  5.     This program once started as a re-make of Mark Howell's Zip, but
  6.     has grown into an utterly new interpreter.
  7.  
  8.     Frotz is freeware: It may be used and distributed freely provided
  9.     no commercial profit is involved. (c) 1995-1997 Stefan Jokisch.
  10.  
  11.     Please report bugs to s.jokisch@avu.de
  12.  
  13. Syntax: frotz [options] story-file
  14.  
  15.     -i         ignore runtime errors
  16.  
  17.     Set this switch and Frotz no longer worries about anything the
  18.     game tries to do. This can help you to get around fatal errors.
  19.  
  20.     -S #     set the width of the transscript file
  21.  
  22.     By default your transscript files are formatted to a width of 80
  23.     columns per line -- regardless of the current screen width. This
  24.     switch allows you to change this setting. In particular, use -S0
  25.     to deactivate automatic line splitting in transscript files.
  26.  
  27.     -c #     set the number of context lines
  28.  
  29.     When the game prints several pages of text in a row, Frotz stops
  30.     for a more prompt after each page. The first prompt appears when
  31.     your input reaches the top of the window. Further prompts appear
  32.     when the previous page has been scrolled off the window. You can
  33.     use this switch to make the latter more prompts appear earlier.
  34.  
  35.     -u #     set the number of undo slots for multiple undo
  36.  
  37.     Frotz tries to allocate as much conventional memory as possible
  38.     for multiple UNDO. If this strategy causes some kind of problem,
  39.     use this switch to set a tighter limit. In particular, you might
  40.     want to turn off the UNDO feature altogether by typing -u0.
  41.  
  42.     -s #     set the random number seed
  43.  
  44.     The given seed value is used as the initial seed value on every
  45.     restart. This is helpful for testing games like 'Curses' which
  46.     make random decisions before the first input (such that the hot
  47.     key Alt-S does not really help). The meaning of seed values is
  48.     explained in the next section.
  49.  
  50.     -x       expand abbreviations (g, x, z ==> again, examine, wait)
  51.  
  52.     This switch was made for old Infocom games that lack the common
  53.     abbreviations introduced in later games. Use it with caution: A
  54.     few games might use "g", "x" or "z" for different purposes.
  55.  
  56.     -o       watch object movement
  57.     -O       watch object locating
  58.     -a       watch attribute assignment
  59.     -A       watch attribute testing
  60.  
  61.     Although these switches may be of assistance while debugging new
  62.     games, they are are actually meant to be cheat functions. The -o
  63.     switch, for example, helps to locate the thief in 'Zork 1' and
  64.     the cat in 'Curses'. The other switches produce a lot of obscure
  65.     messages during the game; but some of these messages might give
  66.     you important clues if you watch carefully.
  67.  
  68.     -t       set the Tandy bit
  69.  
  70.     Some old Infocom games were sold by the Tandy Corporation. These
  71.     games behave slightly different when you use this option. For
  72.     example, 'The Witness' gets censored: bastards turn into idiots,
  73.     private dicks into private eyes and so on.
  74.  
  75.     -p       alter behaviour of piracy opcode
  76.  
  77.     The piracy opcode was never used by Infocom, and this switch is
  78.     only useful for those who like to toy around with Z-code.
  79.  
  80. Special keys:
  81.  
  82.     Alt-D - toggle debugging options (-a, -A, -o, -O)
  83.     Alt-H - help on hot keys
  84.     Alt-N - new game (restart)
  85.     Alt-P - turn on input line playback
  86.     Alt-R - toggle input line recording on/off
  87.     Alt-S - set the random number seed
  88.     Alt-U - multiple undo, works even for old V1 to V4 games
  89.     Alt-X - exit game
  90.  
  91.     When testing a text adventure it can be difficult to reproduce a
  92.     specific bug. To avoid this problem you should use the Alt-R key
  93.     to record all your inputs in a command file. Later you can press
  94.     Alt-P to feed the command file back into Frotz. In many cases,
  95.     however, you will find that the result is different because most
  96.     games contain random events. Luckily, Frotz provides a hot key
  97.     to control these events. Type Alt-S and you are asked for a seed
  98.     value, i.e. a value in the range from 1 to 32767. Normally, you
  99.     would choose a number >= 1000. Smaller values generate a special
  100.     sequence of random numbers as proposed by Nelson. (For instance,
  101.     the seed value 4 generates 1, 2, 3, 4, 1, 2, 3, 4, 1...). In any
  102.     case, random events become predictable until the next restart.
  103.  
  104.     See also the command line option -s above.
  105.  
  106.     tab            - word completion (like "tcsh" under Unix)
  107.  
  108.     When you need to type an unpleasantly long word, try to type the
  109.     first three or four letters then press the tabulator key. If you
  110.     are lucky, Frotz fills in some or all of the missing letters. A
  111.     high beep noise indicates that the word is ambiguous; a low beep
  112.     indicates that it does not exist. Apart from that, you can also
  113.     use the history feature to get to previous input lines. Type the
  114.     beginning of the input line you are looking for, then use cursor
  115.     up/down to scroll through all input lines matching that prefix.
  116.  
  117. List of fatal errors:
  118.  
  119.     - "Bad stack frame"
  120.     - "Byte swapped story file"
  121.     - "Call to illegal address"
  122.     - "Call to non-routine" [1]
  123.     - "Cannot open story file"
  124.     - "Division by zero"
  125.     - "Error reading save file"
  126.     - "Illegal attribute"
  127.     - "Illegal object" [2]
  128.     - "Illegal window"
  129.     - "Illegal window property"
  130.     - "Jump to illegal address"
  131.     - "Nesting stream #3 too deep"
  132.     - "No such property"
  133.     - "Out of memory"
  134.     - "Print at illegal address"
  135.     - "Stack overflow" [3]
  136.     - "Stack underflow" [4]
  137.     - "Store out of dynamic memory"
  138.     - "Story file read error"
  139.     - "Text buffer overflow"
  140.     - "Unknown opcode"
  141.     - "Unknown Z-code version"
  142.  
  143.     [1] The first byte of a routine must be less than 16.
  144.     [2] In V4 and above, object numbers > 2000 are considered illegal.
  145.     [3] Checked on every call instruction.
  146.     [4] Checked on every return from a subroutine.
  147.  
  148. Acknowledgements:
  149.  
  150.     Many thanks to Paul D. Doherty for his continuing support of this
  151.     project. Thanks to everyone who sent bug reports, contributions or
  152.     helpful hints (in alphabetical order):
  153.  
  154.     Thomas Biskup, Ian Carpenter, Graeme Cree, Jason Dyer,
  155.     Carl Edman, Julian Eggebrecht, Bernhard Fuchs, Joe Hachem,
  156.     John Kennedy, Kirk Klobe, Marnix Klooster, John Mackin,
  157.     Paul O'Brian, Magnus Olsson, Barry Prescott, L. Ross Raszewski,
  158.     Ambat Sasi Nair, Alan Sherrod, Linards Ticmanis and Paolo Vece.
  159.  
  160.     Last but not least, thanks to the porters:
  161.  
  162.     David Kinder (Amiga), Rich Lawrence (Windows 95/NT),
  163.     Andrew Holdsworth (RiscOS), Christos Dimitrakakis (HP-UX),
  164.     Christopher J. Madsen (OS/2), Galen Hazelwood (Unix curses library),
  165.     Ian Dean (Windows CE).
  166.  
  167.     Executables are available from ftp.gmd.de and from
  168.  
  169.     http://www.geocities.com/SiliconValley/Heights/3222/frotz.html
  170.  
  171.     which is the Frotz home page maintained by Chris Madsen.
  172.